home *** CD-ROM | disk | FTP | other *** search
/ Cinema Studio: Frank Herrmann / Cinema Studio - Frank Herrmann.iso / tools / pbm / manuals / ppmtoxpm.man < prev    next >
Text File  |  1994-03-01  |  4KB  |  133 lines
  1.  
  2.  
  3.  
  4.      ppmtoxpm(1)          AMIGA (Tue Apr 9 1991)           ppmtoxpm(1)
  5.  
  6.  
  7.  
  8.      NAME
  9.           ppmtoxpm - convert a portable pixmap into an X11 pixmap
  10.  
  11.      SYNOPSIS
  12.           ppmtoxpm [-name <xpmname>] [-rgb <rgb-textfile>] [<ppmfile>]
  13.  
  14.      DESCRIPTION
  15.           Reads a portable pixmap as input.  Produces X11 pixmap
  16.           (version 3) as output which can be loaded directly by the
  17.           XPM library.
  18.  
  19.           The -name option allows one to specify the prefix string
  20.           which is printed in the resulting XPM output.  If not
  21.           specified, will default to the filename (without extension)
  22.           of the <ppmfile> argument.  If -name is not specified and
  23.           <ppmfile> is not specified (i.e. piped input), the prefix
  24.           string will default to the string "noname".
  25.  
  26.           The -rgb option allows one to specify an X11 rgb text file
  27.           for the lookup of color name mnemonics.  This rgb text file
  28.           is typically the /usr/lib/X11/rgb.txt of the MIT X11
  29.           distribution, but any file using the same format may be
  30.           used.  When specified and a RGB value from the ppm input
  31.           matches a RGB value from the <rgb-textfile>, then the
  32.           corresponding color name mnemonic is printed in the XPM's
  33.           colormap.  If -rgb is not specified, or if the RGB values
  34.           don't match, then the color will be printed with the #RGB,
  35.           #RRGGBB, #RRRGGGBBB, or #RRRRGGGGBBBB hexadecimal format.
  36.  
  37.           All flags can be abbreviated to their shortest unique
  38.           prefix.
  39.  
  40.           For example, to convert the file "dot" (found in
  41.           /usr/include/X11/bitmaps), from xbm to xpm one could specify
  42.  
  43.                xbmtopbm dot | ppmtoxpm -name dot
  44.  
  45.           or, with a rgb text file (in the local directory)
  46.  
  47.                xbmtopbm dot | ppmtoxpm -name dot -rgb rgb.txt
  48.  
  49.      BUGS
  50.           An option to match the closest (rather than exact) color
  51.           name mnemonic from the rgb text would be a desirable
  52.           enhancement.
  53.  
  54.           Truncation of the least significant bits of a RGB value may
  55.           result in nonexact matches when performing color name
  56.           mnemonic lookups.
  57.  
  58.      SEE ALSO
  59.           ppm(5)
  60.  
  61.  
  62.  
  63.      Page 1                                           (printed 3/1/94)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      ppmtoxpm(1)          AMIGA (Tue Apr 9 1991)           ppmtoxpm(1)
  71.  
  72.  
  73.  
  74.           XPM Manual by Arnaud Le Hors lehors@mirsa.inria.fr
  75.  
  76.      AUTHOR
  77.           Copyright (C) 1990 by Mark W. Snitily.
  78.  
  79.           Permission to use, copy, modify, and distribute this
  80.           software and its documentation for any purpose and without
  81.           fee is hereby granted, provided that the above copyright
  82.           notice appear in all copies and that both that copyright
  83.           notice and this permission notice appear in supporting
  84.           documentation.  This software is provided "as is" without
  85.           express or implied warranty.
  86.  
  87.           This tool was developed for Schlumberger Technologies, ATE
  88.           Division, and with their permission is being made available
  89.           to the public with the above copyright notice and permission
  90.           notice.
  91.  
  92.           Upgraded to XPM2 by
  93.              Paul Breslaw, Mecasoft SA, Zurich, Switzerland
  94.           (paul@mecazh.uu.ch)
  95.              Thu Nov  8 16:01:17 1990
  96.  
  97.           Upgraded to XPM version 3 by
  98.              Arnaud Le Hors (lehors@mirsa.inria.fr)
  99.              Tue Apr 9 1991
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                           (printed 3/1/94)
  130.  
  131.  
  132.  
  133.